Handling Text in Alert and Dialog Boxes

The following Dialog Manager function for handling text in dialog boxes and alert boxes is changed with Appearance Manager 1.0:

SetDialogItemText

Sets the text string for static text and editable text fields.



 
pascal void SetDialogItemText (

                     Handle item,

                     ConstStr255Param text);

item: A handle to an editable text field or static text field. When embedding is on, you should pass in the control handle produced by a call to the function GetDialogItemAsControl . If embedding is not on, pass in the handle produced by the GetDialogItem function.
text: A pointer to a string containing the text to display in the field.

DISCUSSION

The SetDialogItemText function sets and redraws text strings for static text and editable text fields. SetDialogItemText is useful for supplying a default text string--such as a document name--for an editable text field while your application is running.

VERSION NOTES

Changed with Appearance Manager 1.0 to support embedding hierarchies.